home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
iBrowse Update Disc
/
iBrowse Update Disc.iso
/
distrib
/
man
/
Manuals
/
Omniclient
/
8_AppxB
< prev
next >
Wrap
Text File
|
1998-02-04
|
10KB
|
266 lines
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<TITLE>NFS star commands</TITLE>
<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.04z">
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<P>
<A HREF="7_AppxA" ><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="Front" ><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="TOC" ><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="index" ><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="9_AppxC" ><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<H1>Appendix B: NFS star commands</H1>
<HR>
<H2>*<A NAME="Free">Free</A></H2>
<P>
Displays free space on a mount
<H3>Syntax</H3>
<P>
<TT><FONT FACE="Courier">*Free [<I>mountname</I>]</FONT></TT>
<H3>Parameters</H3>
<P>
<TT><I><FONT /TT> FACE="Courier">mountname</FONT></I></TT> is
the name of an NFS mount point
<H3>Use</H3>
<P>
*Free displays your available free space on a mount, the total
free space on that mount, and the size of the mounted filesystem.
If the mounted filesystem is using quotas, *Free shows your free
and used space on it, the quota beneath which you are expected
to remain, and the absolute limit of usage that you cannot exceed.
<P>
If no mountname is given, the current one is used.
<H3>Example</H3>
<P>
<TT><B><FONT /TT> FACE="Courier">*Free tp1usr</FONT></B></TT>
<P>
<TT><FONT FACE="Courier">No quota on tp1usr<BR>
Space on filing system:<BR>
Free 69 889K<BR>
Available 33 168K<BR>
Size 367 218K</FONT></TT>
<P>
<TT><B><FONT /TT> FACE="Courier">*Free home</FONT></B></TT>
<P>
<TT><FONT FACE="Courier">Bytes free 9 626K<BR>
Bytes used 374K<BR>
Bytes quota 10 000K<BR>
Bytes limit 12 000K</FONT></TT>
<H3>Related commands</H3>
<P>
None
<HR>
<H2>*<A NAME="Logon">Logon</A></H2>
<HR>
<P>
Sets the name server to use and/or authenticates a user/password
pair
<H3>Syntax</H3>
<P>
<TT><FONT FACE="Courier">*Logon [-Host <I>hostname</I>] [<I>username</I>[[CR]<I>password</I>]]</FONT></TT>
<H3>Parameters </H3>
<P>
<TABLE >
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=149><TT><I><FONT /TT> FACE="Courier">hostname</FONT></I></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=419>the host to be used as the name server for this and subsequent name requests
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=149><TT><I><FONT /TT> FACE="Courier">username</FONT></I></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=419>the user whose details are to be authenticated on the name server
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=149><TT><I><FONT /TT> FACE="Courier">password</FONT></I></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=419>the user's password, which - if omitted - you will be prompted for
</TD></TR>
</TABLE>
<H3>Use</H3>
<P>
*Logon sets the name server to use and/or authenticates a user/password
pair, depending on the parameters passed:
<UL>
<LI>if a hostname is given, then it sets the name server to use
for this and subsequent authentication using *Logon
<LI>if a username and password are given, they are passed to the
current name server for authentication; they are also used to
access any mount points you create in the future
<LI>if no parameters are given, then the current user and name
server are displayed.
</UL>
<H3>Examples </H3>
<P>
<TABLE >
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">*Logon -Host tp1</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>Sets tp1 as the current name server.
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">*Logon mhardy</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>Prompts for the password, which is reflected as dashes; authenticates the pair using the current name server (ie tp1); if the password is valid, sets the current user to mhardy.
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">*Logon</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>Displays the current user (mhardy) and the current name server (tp1).
</TD></TR>
</TABLE>
<H3>Related commands</H3>
<P>
*Mount
<HR>
<H2><A NAME="Mount">*Mount</A></H2>
<HR>
<P>
Lists or mounts NFS mount points
<H3>Syntax</H3>
<P>
<TT><FONT FACE="Courier">*Mount [-Host <I>hostname</I>] [<I>mountname</I>
[<I>mountpath</I>]]</FONT></TT>
<H3>Parameters </H3>
<P>
<TABLE >
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=111><TT><I><FONT /TT> FACE="Courier">hostname</FONT></I></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=457>the host to be used as the NFS server for this and subsequent mount requests
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=111><TT><I><FONT /TT> FACE="Courier">mountname</FONT></I></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=457>the name by which RISC OS will refer to this mount point
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=111><TT><I><FONT /TT> FACE="Courier">mountpath</FONT></I></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=457>the directory on the NFS server which shall act as $ on NFS::mountname
</TD></TR>
</TABLE>
<H3>Use</H3>
<P>
*Mount lists or mounts NFS mount points, depending on the parameters
passed:
<UL>
<LI>if a hostname is given, then it sets the host as the NFS server
to be used for this and any subsequent mount requests; it also
lists all mount points on the host, giving the mount name, mount
path and user name for each mount point
<LI>if a mountname and mountpath are given, then the mountpath
is mounted, using the last user name that was successfully authenticated
with *Logon, and the URD, CSD, PSD and Library are all set to
$ (i.e. the mountpath)
<LI>if no mountpath is given, but a mountname is given for which
a mount already exists, then the URD, CSD, PSD and Library are
all reset to $ for that mount
<LI>if no parameters are given, then all current mount points
are listed, showing the mount name, mount path and user name for
each mount point.
</UL>
<P>
The files accessed via a mount point are always accessed using
the details of the user which was current at the time the *Mount
command was executed.
<H3>Examples </H3>
<P>
<TABLE >
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount -Host tp1 tp1usr /usr</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Mounts the directory /usr on the host tp1, giving it the mount name tp1usr.
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount tp1usr</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Resets the URD, CSD, PSD and Library for the mount named tp1usr to $ on that mount
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount -Host tp1</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Lists all mount points on tp1.
</TD></TR>
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=246><TT><FONT FACE="Courier">*Mount</FONT></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=323>Lists all mount points.
</TD></TR>
</TABLE>
<H3>Related commands</H3>
<P>
*<A HREF="#Logon">Logon</A>
<HR>
<H2>*<A NAME="NFS">NFS</A></H2>
<HR>
<P>
Selects NFS as the <A NAME="current">current</A> filing system
<H3>Syntax</H3>
<P>
<TT><FONT FACE="Courier">*NFS</FONT></TT>
<H3>Use</H3>
<P>
*NFS selects NFS as the filing system for subsequent operations.
Remember that it is not necessary to switch filing systems if
you use the full pathnames of objects. For example, you can refer
to ADFS objects when NFS is the current filing system.
<H3>Example</H3>
<P>
<TT><FONT FACE="Courier">*NFS</FONT></TT>
<H3>Related commands</H3>
<P>
*ADFS, *Net, *RAM, *ResourceFS, *SCSI
<HR>
<H2>*NFS<A NAME="Info">Info</A></H2>
<HR>
<P>
Displays NFS module internal statistics
<H3>Syntax</H3>
<P>
<TT><FONT FACE="Courier">*NFSInfo</FONT></TT>
<H3>Use</H3>
<P>
*NFSInfo displays detailed information about NFS module activity,
including known hosts, users, URDs, CSDs, PSDs and Libraries,
and details of its cache performance.
<P>
Most of the information displayed is runic in nature. It is presented
mainly as an aid to trouble-shooting, should you require it.
<H3>Example</H3>
<P>
<TT><B><FONT /TT> FACE="Courier">*NFSInfo</FONT></B></TT>
<P>
<TT><FONT FACE="Courier">Host list:<BR>
name=<tp1>, usage = 1<BR>
name=<tp2>, usage = 1<BR>
name=<tp3>, usage = 2<BR>
<BR>
Cache hits 90051; Cache misses 36385 <BR>
<BR>
User list:<BR>
name=<mhardy>, uid=<1234>, gid=<27>, usage =
1<BR>
name=<nobody>, uid=<32767>, gid=<9999>, usage
= 1<BR>
CSD: 0x1844144, <><BR>
PSD: 0x1844144, <><BR>
URD: 0x1844144, <><BR>
Library: 0x1844144, <></FONT></TT>
<H3>Related commands</H3>
<P>
None
<HR>
<H2>*<A NAME="time">Time</A>Offset</H2>
<HR>
<P>
Sets the time offset in minutes from GMT to local time
<H3>Syntax</H3>
<P>
<TT><FONT FACE="Courier">*TimeOffset <I>minutes</I></FONT></TT>
<H3>Parameters </H3>
<P>
<TABLE >
<TR><TD WIDTH=113><TT><I><FONT /TT> FACE="Courier">minutes</FONT></I></TT>
</TD><TD WIDTH=455>minutes offset from GMT to local time</TD>
</TR>
</TABLE>
<H3>Use</H3>
<P>
*TimeOffset sets the time offset in minutes from GMT to local
time. RISC OS NFS adds this offset when it interprets the server's
date stamps, which it assumes to be in GMT. The offset can be
negative or positive.
<H3>Example</H3>
<P>
<TT><I><FONT /TT> FACE="Courier">*TimeOffset 60</FONT></I></TT>
<H3>Related commands</H3>
<P>
None<BR>
<P>
<A HREF="7_AppxA" ><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="Front" ><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="TOC" ><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="index" ><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<A HREF="9_AppxC" ><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
<P>
</BODY>
</HTML>